Almathera Ten Pack 3: CDPD 3/Almathera Ten on Ten - Disc 3: CDPD3.iso/scope/201-220/scopedisk217/llog/quick_help.doc

Text File | 1995-03-20 | 11.1 KB | 203 lines

                                    LoGG 1.2

                                   QUICK HELP

                     Copyright (c) 1991-92 A. G. Kartsatos


     1)  To run the program with most of the basic functions working, you
will need at least these files in your current "c" directory:

                   CD, ENDCLI, EXECUTE, LoGG.file, RUN, STACK

     Some of these files might be built-in for AmigaDos 2.0 for the 3000.
     LoGG looks for the file "LoGG.file" in your "c" directory as well as
as your current directory.  The program will abort if it does not locate this
file.  This is the file that contains the names of your drives, the 4 colors
and the 48 user-definable gadgets.

     2)  For a fully operational LoGG you will need the following files in
your current "c" directory:

  ARC, CD, EDIT, ENDCLI, EXECUTE, LHARC, LoGG.file, PAK, RUN, STACK, WARP, ZOO

     Some of these files might already be built-in with the Amigados 2.0 of
the Amiga 3000.
     You must name these files exactly as above.  For example, EDIT is
your favourite editor program.  The files CD, ENDCLI, RUN and STACK are your
usual Workbench files.

     3)  To make one of the two windows on your front panel the SOURCE
window, just click into its vertical gadget or anywhere into it.  Then the
other window will automatically become the DESTINATION window.

     4)  Click fast twice on the name of a directory in order to attach to
it.  If a DRIVE is not listed in your list of 14 drives, and you want to
see a pathname in it, just enter the desired pathname into the "D" or "S"
gadget and press <RETURN>.

     5)  Configure LoGG so that it carries your own 4 colors and your own 14
drives.  Attach to a place where you can find your palette.  Run the palette
by selecting it first and then clicking into LoGG's RUN gadget.  Change
any of the 4 colors on the palette (you get 3 HEX numbers for each color),
and then place those 12 numbers in the third line of your LoGG.file.
     To place your own drives in LoGG, just enter 14 drive names into the
first two lines of your LoGG.file.  You may repeat drive names of course.
     After you have made any change to your LoGG.file while you are running
LoGG, just choose the CONFIGURE item of the first menu to get LoGG to adjust
itself to the change.

     6)  Study the file LoGG.file so that you can create up to 48 gadgets
with your own titles and your own commands.
     The titles of the gadgets should be at most 8 characters long.
     The corresponding title entries in the file LoGG.file should be exactly
10 characters long, like "DPAINT   *", "CONTOURA *", etc.  You should not
include the quotes in your LoGG.file.
     The MACROS (Entries 1 - 24 in your LoGG.file) can accommodate up to
7 different command lines each.  Only the first of these commands can contain
the token "CD" in it and a symbol for the CLI as described below.
     Only the first token of the first command line of a MACRO can be "CD".
     The PARMS (Entries 25 - 48 in your LoGG.file) can only carry one
command line.  This command line can have up to 5 tokens and at most 2 para-
meters.  For example,

     "FIXOBJ %s %s (R) (SMALL)", "HELLO %s HERMES %s JULIE (R) (TINY)",
                             "EDITOR %s (FULL)"

are acceptable PARMS command lines.  If there are two parameters (%s) in a
PARMS command, the first one is a highlighted file and the second is a
string that you enter in the file requestor.  If there is only one parameter
in your command line, there are two possibilities: 1) If there is a file
selected (highlighted), LoGG will pick the name of that file for this para-
meter.  2) If there is no selected file, LoGG will bring the requester out
for you to enter a string for this parameter.
     The symbols (TINY), (SMALL) and (FULL) are the sizes of the CLI windows
that you can open with your command.  They are always at the very end of
your command and at least one space away from the previous command token.
     Naturally, you can only use one such symbol per command.
     The symbol "(R)" here means that you want to have the file listing
refreshed after the execution of this command.  The symbol "(R)" must be
placed at the end of your command before any CLI symbol.  "(R)" must again
be at least one space away from from adjacent command token.
     After you have made any change to your LoGG.file while you are running
LoGG, just choose the CONFIGURE item of the first menu to get LoGG to adjust
itself to the change.

     7)  Sometimes your LoGG.file gets funny with some, possibly invisible,
characters in it.  To correct it, just run the file FIX_FILE.  This file
will attempt to correct your LoGG.file and put the corrected contents in
a file called LoGG.file1.  Just rename LoGG.file1 as LoGG.file and continue
as usual.

     8)  IMPORTANT!  Do not forget that you can stop the SEARCHING OF FILES
AND STRINGS, CATALOGING, COPYING AND MOVING OF FILES, etc., by just
clicking into the STOP BUTTON on your front panel.

     9)  To copy files from one of the display windows into another path
not currently on display in the opposite window, you can just enter that
path in the DESTINATION BUFFER "D" and click into the COPY gadget.  When
copying is finished, LoGG will list that destination path.  The same remark
applies to the MOVE operation.

     10)  Pressing QUIT while FORMATTING/DISKCOPYING might corrupt the desti-
nation disk.  Do not use QUIT (on the FORMAT/DISKCOPY requester) unless
it is absolutely necessary.

     11)  READ: This is a fully operational file reader.  It will list
          the selected file and will scroll through it very fast.  It
          has 8 menu items.  We will only elaborate on the items that
          need some explanation.  Just remember that YOU CAN SCROLL
          THE TEXT UP AND DOWN BY USING THE RESPECTIVE ARROW KEYS or by
          CLICKING into the upper or lower half of the reader screen.

               (1) GO TO LINE:  You can choose this menu item, or just
                   press RIGHT_AMIGA-G instead.  As soon as you do that,
                   the GOTO-gadget clears up.  Just go ahead and type
                   in the line number you want to see.  Then press
                   <RETURN>.  The program will then try to exhibit that line
                   as the top line of the page.  Another way of doing this:
                   Just click into the GOTO-gadget, clear it up by using
                   the BACKSPACE key (or pressing RIGHT_AMIGA-X), enter
                   the line number that you wish to exhibit, and then press
                   <RETURN>.
                   The program will do nothing if the line number that you
                   have entered does not exist.


               (2) FIND STRING:  You can choose this menu item, or just
                   press RIGHT_AMIGA-F instead.  As soon as you do that,
                   the FILE-gadget clears up.  Just go ahead and type
                   in the string that you want to see.  Then press
                   <RETURN>.  The program will then try to exhibit that
                   string at the top line of the page.  Another way of doing
                   this: Just click into the FILE-gadget, clear it up by
                   using the BACKSPACE key (or pressing RIGHT_AMIGA-X),
                   enter the string that you wish to exhibit, and then
                   press <RETURN>.
                   The program will do nothing if the string that you have
                   entered does not exist from the current line on.

               (3) SEARCH AGAIN:  Well, now that you have found the string,
                   just choose this menu item or press RIGHT_AMIGA-S to
                   try to find the string again.  The program will try to
                   locate the string and exhibit it at the top line of
                   the page.  Again, the program tries to locate the given
                   string starting from the secong line of your page down
                   to the end of the file.

     12)  You should change to HIRES (clicking into the RESOL gadget) if
you have more than 800 files in the same directory listing.  Otherwise you
will get a partial listing of these files.  If you are using the MEDIUM re-
solution mode and LoGG finds out that there are more than 800 files in your
directory, LoGG will inform you that you should change into the HIRES mode.

     13)  The STOP button does stop a file from being printed to your
printer, but it takes some time before the Amiga responds to the signal
to stop.  So, be a little patient.

     14)  If you get a little confused about the exact name of a file which
is not completely listed, just select the file and click into the FILEINFO
gadget.  The FILEINFO gadget contains the entire name of the file and
information on the file's Protection Bits, Comment and Date of creation.

     15)  Whenever a CLI appears in the execution of a command or in an
archiving process, you should close it by pressing EndCLI.  It is important
that you have this command included in your "c" directory.

     16)  If you change your LoGG icon (this is the program icon, not the
disk icon), please remember to enter the data in the TOOL TYPES gadget in
the new icon as they appear in the original one.
     The icon that LoGG comes with opens a 1-pixel window on your WorkBench
just in case LoGG needs to put some output somewhere.  If you do not take
care of this, LoGG may crash your machine when it tries to write an error
statement into a nonexistent window.

     17)  When a directory has a lot of subdirectories, you may get a list-
ing in one of the panel windows consisting only of directories.  Thus, you
do not see the files which follow below.  If any of these files have been
highlighted and you click into DELETE, you might delete the files without
even ever seeing them.  So, please exercise caution with gadgets like DELETE
and MOVE.  It is good practice to click into the CLEAR gadget from time
to time in order to avoid cases like this.

     18)  If the disk you have just inserted (or a path on it) is listed
in one of your front panel windows, you should refresh that window's listing
by using the SOURCE or DESTINATION gadgets, or by clicking into one of your
drive gadgets.  To see why you need to do this, suppose that you have listed
"DF1:" in your DESTINATION gadget.  Now, suppose that you insert a new disk
in "DF1:" (not the one you have just removed).  Then if you do not refresh
the DESTINATION window, LoGG will think that the current listing there is the
listing of the disk that you have just inserted.  Although no damage can
result from this, you can get a confusing listing of files and directories
in that window if, e.g., you try to copy files there.  LoGG will notify you
to refresh your window(s) whenever disks have been inserted or modified (via
FORMAT, DISKCOPY, etc.).

     19)  Please avoid using names of directories and files that contain
empty spaces in them.  You can always replace, for exampe, "HELLO JOHN" by
"HELLO_JOHN".
     Certain archiving programs (among others) do not work right with such
names.  Although LoGG will do its best to work with such names (in the first
48 built-in gadgets), there is still some overhead in trying to do so.